home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / AMICUS / AMICUS12.ADF / MenuEditor / README < prev    next >
Text File  |  1986-08-05  |  8KB  |  159 lines
  1.             How To Build A Simple Menu Using The Mantis Menu Editor
  2.             -------------------------------------------------------
  3.  
  4. To receive the complete printed manual and the latest revision Menu Editor
  5. on disk, just send $15 to:
  6.  
  7.                            Mantis Development
  8.                            Attn: David Pehrson
  9.                            P.O. Box 4001
  10.                            Bellevue, WA 98009
  11.  
  12. First, let's describe the various screen areas and what they're used for.
  13. At the very top of the screen is the TITLE BAR.  The title bar displays the
  14. version number of this program (as well as the copyright notice).  Below
  15. the title bar is the ICON BAR.  The icons on the icon bar can be used to set
  16. the various attributes of your menu items.  Each icon is described later.
  17. Below the icon bar are two edit fields.  The long field is for entering and
  18. editing your menu titles, items, and sub-items.  The short field to the right
  19. is for your Amiga command key sequence.  There are two large areas below the
  20. edit line; the menu title area (on the left), and the menu item, sub-item area
  21. (on the right).  As you add new menu titles, they will show on the left.
  22. Clicking on a title with the mouse will show the items under that title in
  23. the menu item/sub-item area to the right.
  24.  
  25. Now that you're familiar with the various screen areas, we'll get on with the
  26. tutorial and build a simple menu.  It's a good idea to start up the Menu
  27. Editor now and try out everything in the tutorial.  When you're done, you'll
  28. know the basics of menu creation with the Menu Editor.
  29.  
  30. First, press your right mouse button and select "About" under the "Project"
  31. menu.  After the graphics display, press the "Next" button and you'll get a
  32. brief description of the Menu Editor's features.  After reading, press "Next"
  33. again to see the registration information.  Press "Next" again and you're
  34. back in the Menu Editor.
  35.  
  36. As you can see, the first menu title "Project" is already created for you, as
  37. well as one blank menu item.  Let's start by adding a couple new menu titles;
  38. "Edit" and "Options".  Click on the word "Project".  The title "Project" will
  39. appear in the edit field above the menu titles.  Select the option "Append"
  40. from the "Edit" pull-down menu and a new title (titled "New Title" of course)
  41. will appear.  To change "New Title" to "Edit", just type:
  42.  
  43. <spacebar>Edit<return>
  44.  
  45. <spacebar> means press your spacebar, and <return> means type your return key.
  46. We type a space before each title to keep our titles from looking crowded and
  47. bunched together.  If you made a typing mistake, don't worry, we'll cover
  48. editing a little later.  Now append another title (you can use the short-cut
  49. Right-Amiga-A key sequence if you want).  For this title, Type in:
  50.  
  51. <spacebar>Options<return>
  52.  
  53. You now have 3 menu titles, "Project", "Edit", and "Options".  Press the
  54. button labeled "Test" on the Icon Bar.  Now press the right menu button.  Your
  55. own menu titles should appear on the title bar.  Press "Test" again to restore
  56. the Menu Editor's menus.  You can always use the test button to see what your
  57. menus look like.
  58.  
  59. It's time to add some items under our titles.  Click on "Project".  Then,
  60. click in the blank field in the menu item area to the right.  Type in:
  61.  
  62. About<tab>A<return>
  63.  
  64. You just created a menu item "About" that will respond to the Right-Amiga-A
  65. key sequence.  Let's create another item, "Open...".  Append another item and
  66. type:
  67.  
  68. Open...<return>
  69.  
  70. Now let's attach a sub-menu to our "Open" item.  Select "Attach Subitem" from
  71. the "Edit" menu and a sub-item will be added to the right of the "Open..."
  72. item.  You enter the text for a sub-item just like you do for a regular item.
  73. You can also append more items if you want.
  74.  
  75. Let's try editing the text for one of the menu items.  Click on the "About"
  76. item.  The word "About" will show in the edit field.  Use the mouse to place
  77. your cursor anywhere in the edit field.  Move your mouse to just after the "t"
  78. in "About" and click the button.  The cursor will appear, and you can type:
  79.  
  80. <spacebar> My Program<return>
  81.  
  82. The whole text should say "About My Program" now.  Notice how the menu is
  83. automatically re-sized to fit your longer text.  You now have a basic menu,
  84. so let's play with the attribute icons a bit.  The different icons are (from
  85. left to right):
  86.  
  87. P:  Sets this menu item to use the Plain text style.
  88. B:  Sets this menu item to use the Bold text style.
  89. I:  Sets this menu item to use the Italics text style.
  90. U:  Sets this menu item to use the Underlined text style.
  91.  
  92. You can combine bold, italics, and underline in any combination you choose,
  93. and use plain to restore menu items to normal.
  94.  
  95. Box:  Sets this menu item to use the Box selection mode.  When you select a
  96.    menu item that has this attribute set, it draws a box around the text
  97.    instead of complementing (inverting) it.  This method of selection is NOT
  98.    recommended for textual menu items.
  99. Comp:  Sets this menu item to use the Complement selection mode.  Menus with
  100.    this attribute are complemented (inverted) verses boxed.
  101.  
  102. Test:  This icon sets the test mode, allowing you to view your menus just as
  103.    they will be when you add them to your own program.  Remember to turn
  104.    test mode off when you return to editing your menus or the Amiga-key
  105.    short-cuts won't work.
  106.  
  107. E/D:  This allows you to enable/disable menu items.  Disable items are shown
  108.    in a 'greyed' fashion.
  109.  
  110. <check-mark>:  You can add check marks to your menu items too.  Since the
  111.    check marks are added to the left of your item text, type 3 spaces before
  112.    the text, leaving enough space for the check mark.
  113.  
  114. SME:  Set Mutual Exclusion is an advanced feature explained in the printed
  115.    document you receive with your registered copy of the Menu Editor.
  116.  
  117. TOG:  As of this release (1.1) of the operation system, menu toggling is not
  118.    available.  The 1.2 operating system release should fix this problem and
  119.    the Menu Editor will be updated to support this feature.
  120.  
  121. Play with the different icons a bit, and use the test button to see how they
  122. affect your final menus.  There is a sample menu using all the different
  123. attributes already created for you on disk.  To load the sample menus, select
  124. "Open..." under the "Project" menu.  Be sure the test button is off, or you
  125. won't get the correct menus.  The open requester will display all available
  126. files with filenames ending with a ".menu".  The one we want should be called
  127. "Sample.menu".  Click on it, and press the "OK" button.  The details of the
  128. Open requester are described in the full manual.  Suffice it to say there
  129. are many short-cuts not immediately obvious to the user.  If you are
  130. interested in using the Open/Save requester (our "Standard File Package") in
  131. your own programs, please let us know.  Play with the sample menu using the
  132. test button to see all the available attributes.
  133.  
  134. After you create your own menu, you can save them out in two different
  135. formats.  First, if you want to be able to update/change your menus later,
  136. save them out using the "Binary Format".  That's the format the sample menu
  137. is saved under.  When you are ready to add your menus to your program, save
  138. them out using the "C Format".  The Menu Editor will write a standard text
  139. file you simply compile with your 'C' compiler (currently, both the Lattice
  140. and Manx compilers are supported).
  141.  
  142. To actually attach the menu to your program takes only 4 easy steps.
  143.  
  144. 1. Compile your menus.
  145. 2. Add this instruction to your variable declarations:
  146.     extern struct Menu Titles[];
  147. 3. After you've opened a window you want to attach these menus to, add this
  148.    statement:
  149.     SetMenuStrip(yourWindowPointer, Titles);
  150. 4. When you link your program, link it to your compiled menu file before you
  151.    link to your libraries.
  152.  
  153. What could be easier?  Please remember, this program is "Freeware".  If you
  154. use this program, please support its author by sending your $15 registration
  155. fee to Mantis Development, at the above address.  Thank you for supporting
  156. the "Freeware" form of software distribution.
  157.  
  158. Mantis Development
  159.